Изображения
+++++++++++

Получение всех доступных моделей для генерации изображений
==========================================================

Для получения массива доступных моделей достаточно отправить
GET-запрос на эндпоинт ``https://api.air.fail/public/image``,
добавив в заголовок авторизации свой API-ключ:

``Authorization: sk-...``

.. raw:: html

   <details>
   <summary>Показать код</summary>
1. Пример на Python (Библиотека requests)

.. code-block:: python

    import requests

    url = "https://api.air.fail/public/image"
    api_key = "<API-ключ>"
    headers = {"Authorization": api_key}
    response = requests.get(url, headers=headers)
    print(response.json())
2. Пример на Python (Библиотека httpx)

.. code-block:: python

    import httpx

    url = "https://api.air.fail/public/image"
    api_key = "<API-ключ>"
    headers = {"Authorization": api_key}
    response = httpx.get(url, headers=headers)
    print(response.json())

.. raw:: html

   </details>
    <br>
Платформа регулярно обновляется новыми моделями, поэтому результат может меняться.

Обращение к модели генерации изображений
========================================

Для обращения к конкретной модели достаточно отправить 
POST-запрос на тот же эндпоинт, дополнив его названием модели
и передав в теле запроса :doc:`объект Message</DTO/Объект Message>`.
Результатом обращения будет массив,
состоящий из :doc:`объектов Message</DTO/Объект Message>`,
но пришедших от нейронной модели.

Пример эндпоинта для Flux Pro Ultra: ``https://api.air.fail/public/image/fluxproultra``.

Получение параметров для модели
===============================

1. Генерация изображения на **CURL**

    Обычная генерация

    .. code-block:: bash

        curl -X POST "https://api.air.fail/public/image/fluxproultra" \
          -H "Authorization: <API-ключ>" \
          -F "content=Большой белый мишка" \
          -F 'info={"version":"flux-1.1-pro"}'
    Генерация с прикрепленным файлом

    .. code-block:: bash

        curl -X POST "https://api.air.fail/public/image/fluxproultra" \
          -H "Authorization: <API-ключ>" \
          -F "content=Большой белый мишка" \
          -F 'info={"version":"flux-1.1-pro"}'
          -F "file=@example.png"

2. Генерация изображения на **Python**

    Обычная генерация (Библиотека requests)

    .. code-block:: python

        import requests
        import json

        url = "https://api.air.fail/public/image/fluxproultra"
        api_key = "<API-ключ>"
        form_data = {
            "content": "Большой белый мишка",
            "info": json.dumps({
                "version": "flux-1.1-pro",
            })
        }
        headers = {
            "Authorization": api_key
        }
        response = requests.post(url, data=form_data, headers=headers, timeout=120)
        print(response.json())
    Генерация с прикрепленным файлом (Библиотека requests)

    .. code-block:: python

        import requests
        import json

        url = "https://api.air.fail/public/image/fluxproultra"
        api_key = "<API-Ключ>"
        form_data = {
            "content": "Большой белый мишка",
            "info": json.dumps({
                "version": "flux-1.1-pro",
            })
        }
        headers = {"Authorization": api_key}
        files = {"file": ("example.png", open("example.png", "rb"))}
        response = requests.post(url, data=form_data, files=files, headers=headers, timeout=120)
        print(response.json())

    Обычная генерация (Библиотека httpx)

    .. code-block:: python

        import httpx
        import json

        url = "https://api.air.fail/public/image/fluxproultra"
        api_key = "<API-ключ>"
        form_data = {
            "content": "Большой белый мишка",
            "info": json.dumps({
                "version": "flux-1.1-pro",
            })
        }
        headers = {
            "Authorization": api_key
        }
        response = httpx.post(url, data=form_data, headers=headers, timeout=120)
        print(response.json())
    Генерация с прикрепленным файлом (Библиотека httpx)

    .. code-block:: python

        import httpx
        import json

        url = "https://api.air.fail/public/image/fluxproultra"
        api_key = "<API-ключ>"
        form_data = {
            "content": "Большой белый мишка",
            "info": json.dumps({
                "version": "flux-1.1-pro",
            })
        }
        headers = {
            "Authorization": api_key
        }
        files = {"file": ("example.png", open("example.png", "rb"))}
        response = httpx.post(url, data=form_data, files=files, headers=headers, timeout=120)
        print(response.json())